Developer CD Series 1992 June: ROMin Holiday

home *** CD-ROM | disk | FTP | other *** search

/ Developer CD Series 1992 June: ROMin Holiday / ADC Developer CD (1992-06) (''ROMin Holiday'')_iso / Developer Connection - 06-1992.iso / Developer Essentials / Technical Docs / Inside Macintosh / Inside Macintosh Vol. VI / Support files / Browser.d next >

Wrap

Text File | 1991-04-17 | 94.3 KB | 3,848 lines | [TEXT/tefi]

æKY Document.Info æT standardDocument æKY Document.SeqChapters æN Preface Introduction to the System Software Version 7.0 Environment User Interface Guidelines Compatibility Guidelines Edition Manager Event Manager Apple Event Manager Program-To-Program Communications Toolbox Data Access Manager Finder Interface Control Panels Help Manager Font Manager Resource Manager Worldwide Software Overview TextEdit Graphics Overview Color QuickDraw Picture Utilities Package Color Picker Package Palette Manager Graphics Devices Manager Sound Manager Time Manager Notification Manager File Manager Standard File Package Alias Manager Memory Management Process Management Slot Manager Power Manager AppleTalk Manager Appendix A: Result Codes Appendix B: Routines and Their Memory Behavior Appendix C: System Traps Appendix D: Global Variables Appendix E: The Standard Roman Character Set Glossary æC card currentCardNumber card 44 card 67 card 112 card 167 card 227 card 259 card 324 card 359 card 404 card 443 card 465 card 508 card 526 card 555 card 708 card 757 card 777 card 815 card 831 card 850 card 883 card 910 card 992 card 1012 card 1026 card 1072 card 1089 card 1114 card 1175 card 1196 card 1215 card 1243 card 1300 card 1302 card 1303 card 1306 card 1307 card 1309 æKY Document.AlphaChapters æN Alias Manager Appendix A: Result Codes Appendix B: Routines and Their Memory Behavior Appendix C: System Traps Appendix D: Global Variables Appendix E: The Standard Roman Character Set Apple Event Manager AppleTalk Manager Color Picker Package Color QuickDraw Compatibility Guidelines Control Panels Data Access Manager Edition Manager Event Manager File Manager Finder Interface Font Manager Glossary Graphics Devices Manager Graphics Overview Help Manager Introduction to the System Software Version 7.0 Environment Memory Management Notification Manager Palette Manager Picture Utilities Package Power Manager Preface Process Management Program-To-Program Communications Toolbox Resource Manager Slot Manager Sound Manager Standard File Package TextEdit Time Manager User Interface Guidelines Worldwide Software Overview æC card 1089 card 1300 card 1302 card 1303 card 1306 card 1307 card 259 card 1243 card 831 card 777 card 112 card 443 card 359 card 167 card 227 card 1026 card 404 card 508 card 1309 card 883 card 757 card 465 card 44 card 1114 card 1012 card 850 card 815 card 1215 card currentCardNumber card 1175 card 324 card 526 card 1196 card 910 card 1072 card 708 card 992 card 67 card 555 æKY Preface.Sections æN About Inside Macintosh The Development Environment The System Software Environment The Format of a Typical Chapter The Conventions Used in This Volume Other Documentation An Overview of the Chapters in Volume VI Introduction to the Version 7.0 Environment User Interface Guidelines Compatibility Guidelines The Edition Manager The Event Manager The Apple Event Manager The Program-to-Program Communications Toolbox The Data Access Manager The Finder Interface Control Panels The Help Manager The Font Manager The Resource Manager Worldwide Software Overview TextEdit Graphics Overview Color QuickDraw The Picture Utilities Package The Color Picker Package The Palette Manager The Graphics Devices Manager The Sound Manager The Time Manager The Notification Manager The File Manager The Standard File Package The Alias Manager Memory Management Process Management The Slot Manager The Power Manager The AppleTalk Manager A Road Map to Volume VI æC card 4 card 5 card 6 card 7 card 8 card 9 card 10 card 11 card 12 card 13 card 14 card 15 card 16 card 17 card 18 card 19 card 20 card 21 card 22 card 23 card 24 card 25 card 26 card 27 card 28 card 29 card 30 card 31 card 32 card 33 card 34 card 35 card 36 card 37 card 38 card 39 card 40 card 41 card 42 card 43 æKY Preface.Figures æN Figure P-1 A road map to Volume VI æC line 3 of card 43 æKY Introduction to the System Software Version 7.0 Environment.Sections æN About This Chapter About the Version 7.0 Environment The Cooperative Multitasking Environment Interapplication Communication Sharing Data Among Applications Sending Events Between Applications Exchanging Message Blocks Between Programs Remote Data Access Enhanced User Interface Sound TrueType Fonts Graphics File Management Memory Management Temporary Memory 24-Bit and 32-Bit Addressing Process Management Timing Services Compatibility Worldwide Development Communication Over a Network Hardware Interfaces Overview of Chapters In This Volume æC card 44 card 45 card 46 card 47 card 48 card 49 card 50 card 51 card 52 card 53 card 54 card 55 card 56 card 57 card 58 card 59 card 60 card 61 card 62 card 63 card 64 card 65 card 66 æKY Introduction to the System Software Version 7.0 Environment.Figures æN Figure 1-1 Features of the system software version 7.0 environment Figure 1-2 Managers in the interapplication communications architecture Figure 1-3 Using interapplication communication Figure 1-4 Applications using interapplication communication Figure 1-5 A publisher, an edition, and a subscriber Figure 1-6 Sharing dynamic data with other applications Figure 1-7 Sending events to other applications Figure 1-8 Requesting data from a remote database Figure 1-9 Comparison of TrueType and bitmapped fonts Figure 1-10 Using multiple scripts in a single document Figure 1-11 Overview of chapters in Volume VI æC line 28 of card 45 line 11 of card 47 line 36 of card 47 line 39 of card 47 line 11 of card 48 line 18 of card 48 line 15 of card 49 line 7 of card 51 line 13 of card 54 line 17 of card 63 line 7 of card 66 æKY User Interface Guidelines.Sections æN About This Chapter User Interface Design Principles Worldwide Software Development Cultural Values Resources Language Differences Text Display and Text Editing Default Alignment of Interface Elements Keyboards Fonts User Documentation Terminology The Version 7.0 Environment User Feedback Background Notification Color Design for Version 7.0 General Color Design Guidelines The Icon Family Black-and-White Icons Small Icons Color Icons Consistent Use of Icons Customized Icons Windows Window Positions The Zoom Box and Window Behavior Dialog Boxes Modal Dialog Box Behaviors Movable Modal Dialog Boxes Keyboard Navigation in Dialog Boxes Button Labels Dialog Box Layout Dialog Box Messages Standard File Dialog Boxes Save Changes Dialog Box Menus File Menu Edit Menu Font Menu Help Menu Keyboard Equivalents Pop-Up Menus Standard Pop-Up Menus Type-In Pop-Up Menus More User Interface Information æC card 67 card 68 card 69 card 70 card 71 card 72 card 73 card 74 card 75 card 76 card 77 card 78 card 79 card 80 card 81 card 82 card 83 card 84 card 85 card 86 card 87 card 88 card 89 card 90 card 91 card 92 card 93 card 94 card 95 card 96 card 97 card 98 card 99 card 100 card 101 card 102 card 103 card 104 card 105 card 106 card 107 card 108 card 109 card 110 card 111 æKY User Interface Guidelines.Figures æN Figure 2-1 Dual carets in mixed-directional text Figure 2-2 Multidirectional text correctly highlighted Figure 2-3 Reversing the alignment of dialog box items Figure 2-4 The Keyboard menu Figure 2-5 The boundaries of a font Figure 2-6 A progress indicator Figure 2-7 The Application menu with a notification symbol Figure 2-8 An icon family Figure 2-9 A well-designed icon and its selected version Figure 2-10 A poorly designed icon and its selected version Figure 2-11 Default system icons in black and white Figure 2-12 Examples of control panel icons Figure 2-13 A movable modal dialog box Figure 2-14 A Finder movable modal dialog box Figure 2-15 A selected scrolling list Figure 2-16 A dialog box with OK and Cancel buttons Figure 2-17 A dialog box with OK instead of a Cancel button Figure 2-18 A progress indicator that uses a Stop button Figure 2-19 A confirmation alert box Figure 2-20 The recommended spacing of buttons and text in a dialog box Figure 2-21 A well-written dialog box message Figure 2-22 The new standard file dialog box for opening files Figure 2-23 The save changes dialog box Figure 2-24 A sample Edit menu Figure 2-25 A hierarchical menu with Edition Manager commands Figure 2-26 A sample pull-down Size menu and font size dialog box Figure 2-27 The Help menu Figure 2-28 The appearance of a version 7.0 pop-up menu Figure 2-29 An open version 7.0 pop-up menu Figure 2-30 A type-in pop-up menu Figure 2-31 A type-in pop-up menu with user’s choice added æC line 17 of card 73 line 22 of card 73 line 7 of card 74 line 7 of card 75 line 6 of card 76 line 3 of card 80 line 3 of card 81 line 3 of card 84 line 3 of card 85 line 8 of card 85 line 36 of card 89 line 43 of card 89 line 5 of card 95 line 12 of card 95 line 7 of card 96 line 9 of card 97 line 16 of card 97 line 23 of card 97 line 30 of card 97 line 3 of card 98 line 3 of card 99 line 5 of card 100 line 9 of card 101 line 15 of card 104 line 20 of card 104 line 5 of card 105 line 3 of card 106 line 3 of card 109 line 8 of card 109 line 3 of card 110 line 8 of card 110 æKY User Interface Guidelines.Tables æN Table 2-1 Examples of keyboard icons Table 2-2 Pattern substitutions for colors in keyboard icons Table 2-3 Translation chart for user documentation Table 2-4 Apple reserved keyboard equivalents for all systems Table 2-5 Additional reserved keyboard equivalents for worldwide systems Table 2-6 Other common keyboard equivalents æC line 21 of card 75 line 28 of card 75 line 6 of card 78 line 4 of card 107 line 18 of card 107 line 37 of card 107 æKY Compatibility Guidelines.Sections æN About This Chapter About Compatibility Using Memory Wisely Using Assembly Language Accessing Hardware Using Low-Memory Global Variables Determining Whether a Trap Is Available Running in System Software Version 7.0 Allowing Multiple Applications Supporting Required Apple Events Removing Font Size Restrictions Operating With Virtual Memory Enabling Menus During a Modal Dialog Coexisting With the System Menus Creating Movable Modal Dialog Boxes Creating Pop-Up Menus Manipulating Dialog Item Lists Counting Items in a Dialog Item List Appending Items to a Dialog Item List Shortening a Dialog Item List Localizing Macintosh Programs General Guidelines Localizing With the Toolbox Running Macintosh Programs Under A/UX How the A/UX Toolbox Works Using the A/UX Toolbox A/UX Compatibility Guidelines About the Gestalt Manager Using the Gestalt Manager Determining Features of the Operating Environment Determining Whether Gestalt Is Available Interpreting Gestalt Responses Interpreting Responses to Environmental Selectors Interpreting Responses to Informational Selectors Adding Gestalt Selectors Modifying Gestalt Selectors Specifying Gestalt Selector Functions Gestalt Manager Routines Getting Information About the Operating Environment Adding Selector Codes Modifying Selector Codes Summary of the Gestalt Manager Constants Routines Application-Defined Routines Result Codes Summary of the Window Manager Constants Summary of the Control Manager Constants Data Type Summary of the Dialog Manager Constants Data Type Routines æC card 112 card 113 card 114 card 115 card 116 card 117 card 118 card 119 card 120 card 121 card 122 card 123 card 124 card 125 card 126 card 127 card 128 card 129 card 130 card 131 card 132 card 133 card 134 card 135 card 136 card 137 card 138 card 139 card 140 card 141 card 142 card 143 card 144 card 145 card 146 card 147 card 148 card 149 card 150 card 151 card 152 card 153 card 154 card 155 card 156 card 157 card 158 card 159 card 160 card 161 card 162 card 163 card 164 card 165 card 166 æKY Compatibility Guidelines.Figures æN Figure 3-1 The size menu for a bitmapped font Figure 3-2 The size menu for an outline font Figure 3-3 A pop-up menu in its inactive and active states Figure 3-4 A pop-up control that is right-aligned Figure 3-5 An initial dialog box and a list of items to append Figure 3-6 The dialog box after items are overlaid Figure 3-7 The dialog box after items are appended to the right Figure 3-8 The dialog box after items are appended to the bottom Figure 3-9 The dialog box after items are appended relative to Item 2 Figure 3-10 An application, the A/UX Toolbox, and ROM code æC line 5 of card 122 line 10 of card 122 line 3 of card 127 line 44 of card 127 line 18 of card 130 line 23 of card 130 line 30 of card 130 line 37 of card 130 line 44 of card 130 line 11 of card 136 æKY Compatibility Guidelines.Tables æN Table 3-1 Status of User Interface Toolbox and Macintosh Operating System æC line 4 of card 137 æKY Compatibility Guidelines.Listings æN Listing 3-1 Determining whether a trap is available Listing 3-2 Determining whether Gestalt is available Listing 3-3 Using Gestalt to determine the Time Manager version Listing 3-4 Interpreting a bit field response Listing 3-5 Installing a selector function into the system heap Listing 3-6 Defining a new Gestalt function æC line 13 of card 118 line 4 of card 142 line 23 of card 142 line 32 of card 143 line 11 of card 146 line 73 of card 146 æKY Edition Manager.Sections æN About This Chapter About the Edition Manager Publishers, Subscribers, and Editions Using The Edition Manager Receiving Apple Events From the Edition Manager Creating the Section Record and Alias Record Saving a Document Containing Sections Opening and Closing a Document Containing Sections Reading and Writing a Section Formats in an Edition Opening an Edition Format Marks Reading and Writing Edition Data Closing an Edition Creating a Publisher Creating the Edition Container Opening an Edition Container to Write Data Creating a Subscriber Opening an Edition Container to Read Data Choosing Which Edition Format to Read Using Publisher and Subscriber Options Publishing a New Edition While Saving or Manually Subscribing to an Edition Automatically or Manually Canceling Sections Within Documents Locating a Publisher Through a Subscriber Renaming a Document Containing Sections Displaying Publisher and Subscriber Borders Text Borders Spreadsheet Borders Object-Oriented Graphics Borders Bitmapped Graphics Borders Duplicating Publishers and Subscribers Modifying a Subscriber Relocating an Edition Customizing Dialog Boxes Subscribing To Non-Edition Files Getting the Current Edition Opener Setting an Edition Opener Calling an Edition Opener Procedure Opening and Closing Editions Listing Files That Can Be Subscribed To Reading From and Writing to Files Calling a Format I/O Procedure Edition Manager Routines Initializing the Edition Manager Creating and Registering a Section Creating and Deleting an Edition Container Setting and Locating a Format Mark Reading in Edition Data Writing out Edition Data Closing an Edition After Reading or Writing Displaying Dialog Boxes Locating a Publisher and Edition From a Subscriber Edition Container Formats Reading and Writing Non-Edition Files Summary of the Edition Manager Constants Data Types Routines Result Codes æC card 167 card 168 card 169 card 170 card 171 card 172 card 173 card 174 card 175 card 176 card 177 card 178 card 179 card 180 card 181 card 182 card 183 card 184 card 185 card 186 card 187 card 188 card 189 card 190 card 191 card 192 card 193 card 194 card 195 card 196 card 197 card 198 card 199 card 200 card 201 card 202 card 203 card 204 card 205 card 206 card 207 card 208 card 209 card 210 card 211 card 212 card 213 card 214 card 215 card 216 card 217 card 218 card 219 card 220 card 221 card 222 card 223 card 224 card 225 card 226 æKY Edition Manager.Figures æN Figure 4-1 The default edition icon Figure 4-2 A publisher, an edition, and a subscriber Figure 4-3 The publisher dialog box Figure 4-4 The subscriber dialog box Figure 4-5 A document and its corresponding editions Figure 4-6 Publisher and subscriber borders Figure 4-7 Edition Manager commands in the Edit menu Figure 4-8 Edition Manager commands under Publishing Figure 4-9 A document with a publisher & subscriber & its resource fork Figure 4-10 The new publisher alert box Figure 4-11 A sample publisher dialog box Figure 4-12 A sample subscriber dialog box Figure 4-13 Publisher update mode set to On Save Figure 4-14 Publisher update mode set to Manually Figure 4-15 Subscriber update mode set to Automatically Figure 4-16 Subscriber update mode set to Manually Figure 4-17 Edit menu with Show/Hide Borders menu command Figure 4-18 Publisher borders Figure 4-19 Subscriber borders Figure 4-20 A publisher with contents removed Figure 4-21 A publisher border within a spreadsheet document Figure 4-22 A publisher border with resize handles Figure 4-23 A publisher and subscriber with clipped graphics Figure 4-24 Creating multiple publishers alert box Figure 4-25 Saving multiple publishers alert box Figure 4-26 Subscribing directly to a 'PICT' file æC line 16 of card 169 line 21 of card 169 line 30 of card 169 line 48 of card 169 line 65 of card 169 line 74 of card 169 line 93 of card 169 line 102 of card 169 line 13 of card 172 line 5 of card 173 line 10 of card 181 line 7 of card 184 line 10 of card 187 line 16 of card 187 line 24 of card 187 line 30 of card 187 line 5 of card 193 line 20 of card 193 line 25 of card 193 line 13 of card 194 line 3 of card 195 line 5 of card 196 line 12 of card 196 line 5 of card 198 line 10 of card 198 line 11 of card 202 æKY Edition Manager.Listings æN Listing 4-1 Accepting Section Read events and verifying if a section is registered Listing 4-2 Saving a document containing sections Listing 4-3 Opening a document containing sections Listing 4-4 Creating a publisher Listing 4-5 Writing data to an edition Listing 4-6 Creating a subscriber Listing 4-7 Reading in edition data Listing 4-8 Responding to action codes Listing 4-9 Using your own edition opener function æC line 44 of card 171 line 19 of card 173 line 27 of card 174 line 24 of card 182 line 16 of card 183 line 66 of card 184 line 15 of card 186 line 67 of card 187 line 119 of card 205 æKY Event Manager.Sections æN About This Chapter About the Event Manager Introduction to Events Low-Level Events Operating-System Events High-Level Events Event Processing The Event Loop Event Masks Switching Contexts Specifying Memory Requirements and Scheduling Options The Structure of a 'SIZE' Resource Creating a 'SIZE' Resource Using the Event Manager Receiving Low-Level Events Responding to Operating-System Events Receiving High-Level Events Identifying High-Level Event Senders and Receivers Sending High-Level Events Requesting Return Receipts Responding to Events From Other Applications Searching for a Specific High-Level Event Event Manager Routines Receiving Events Sending Events Receiving a Specific High-Level Event Converting Process Serial Numbers and Port Names Summary of the Event Manager Constants Data Types Routines Result Codes æC card 227 card 228 card 229 card 230 card 231 card 232 card 233 card 234 card 235 card 236 card 237 card 238 card 239 card 240 card 241 card 242 card 243 card 244 card 245 card 246 card 247 card 248 card 249 card 250 card 251 card 252 card 253 card 254 card 255 card 256 card 257 card 258 æKY Event Manager.Figures æN Figure 5-1 Events in a single application environment Figure 5-2 Events in a multi-application environment Figure 5-3 Events in system software version 7.0 æC line 12 of card 230 line 5 of card 231 line 8 of card 232 æKY Event Manager.Listings æN Listing 5-1 A simple event loop Listing 5-2 Processing events Listing 5-3 A template for a 'SIZE' resource Listing 5-4 The Rez input for a sample 'SIZE' resource Listing 5-5 Posting a high-level event by application signature Listing 5-6 Using the PPCBrowser function to post a high-level event Listing 5-7 Accepting a high-level event æC line 6 of card 234 line 29 of card 234 line 13 of card 238 line 158 of card 238 line 23 of card 245 line 74 of card 245 line 9 of card 247 æKY Apple Event Manager.Sections æN About This Chapter About the Apple Event Manager Introduction to Apple Events Types of Apple Events Components of Apple Events Data Structures Within Apple Events Responding to Apple Events Requesting Services Through Apple Events Using the Apple Event Manager Accepting an Apple Event Installing Entries Into the Apple Event Dispatch Tables Handling the Required Apple Events Required Apple Events Handling the Open Application Event Handling the Open Documents Event Handling the Print Documents Event Handling the Quit Application Event Handling Apple Events Sent by the Edition Manager Handling the Create Publisher Event Getting Data out of an Apple Event Getting Data out of a Parameter Getting Data out of an Attribute Getting Data out of a Descriptor List Writing Apple Event Handlers Replying to an Apple Event Disposing of Apple Event Data Structures Interacting With the User Creating an Apple Event Adding Parameters to an Apple Event Specifying a Target Address Sending an Apple Event Dealing With Timeouts Writing an Idle Function Writing a Reply Filter Function Writing and Installing Coercion Handlers The Application Died Event Apple Event Manager Routines Creating and Managing the Apple Event Dispatch Tables Dispatching Apple Events Getting Parameters and Attributes From Apple Events Counting the Items in Descriptor Lists Getting Items From Descriptor Lists Getting Data From AE Records Requesting User Interaction Requesting More Time to Respond to Apple Events Suspending and Resuming Apple Event Handling Creating Apple Events Creating and Duplicating Descriptor Records Creating Descriptor Lists and AE Records Adding Items to Descriptor Lists Adding Data to AE Records Adding Parameters and Attributes to Apple Events Sending Apple Events Getting the Sizes and Descriptor Types Deleting Descriptor Records Deallocating Memory for Descriptor Records Coercing Descriptor Types Creating and Managing the Coercion Handler Tables Creating and Managing the Special Handler Tables Summary of the Apple Event Manager Constants Data Types Routines Result Codes Assembly-Language Information æC card 259 card 260 card 261 card 262 card 263 card 264 card 265 card 266 card 267 card 268 card 269 card 270 card 271 card 272 card 273 card 274 card 275 card 276 card 277 card 278 card 279 card 280 card 281 card 282 card 283 card 284 card 285 card 286 card 287 card 288 card 289 card 290 card 291 card 292 card 293 card 294 card 295 card 296 card 297 card 298 card 299 card 300 card 301 card 302 card 303 card 304 card 305 card 306 card 307 card 308 card 309 card 310 card 311 card 312 card 313 card 314 card 315 card 316 card 317 card 318 card 319 card 320 card 321 card 322 card 323 æKY Apple Event Manager.Figures æN Figure 6-1 An Open Documents event Figure 6-2 Major components of an Open Documents event Figure 6-3 A descriptor record with event class data Figure 6-4 A keyword-specified descriptor record Figure 6-5 A descriptor list for a list of aliases Figure 6-6 Data structures within an Open Documents event Figure 6-7 Accepting and processing an Open Documents event Figure 6-8 Handler for an Open Documents event Figure 6-9 Responding to an Open Documents event æC line 7 of card 261 line 39 of card 263 line 56 of card 264 line 116 of card 264 line 126 of card 264 line 145 of card 264 line 28 of card 265 line 35 of card 265 line 133 of card 265 æKY Apple Event Manager.Tables æN Table 6-1 Coercion handling provided by the Apple Event Manager æC line 63 of card 293 æKY Apple Event Manager.Listings æN Listing 6-1 A DoEvent procedure Listing 6-2 A DoHighLevelEvent procedure for handling Apple events and Listing 6-3 Inserting entries for required Apple events into an application’s Listing 6-4 Inserting entries for Apple events sent by the Edition Manager into Listing 6-5 A handler for the Open Application event Listing 6-6 A handler for the Open Documents event Listing 6-7 A handler for the Print Documents event Listing 6-8 A handler for the Quit Application event Listing 6-9 A handler for the Create Publisher event Listing 6-10 Extracting items from a descriptor list Listing 6-11 A function that checks for a keyMissedKeywordAttr attribute Listing 6-12 Adding the keyErrorString parameter to the reply Apple event Listing 6-13 Adding parameters to the reply Apple event Listing 6-14 Using the AEInteractWithUser function Listing 6-15 Creating a target address Listing 6-16 Specifying a target address in an Apple event Listing 6-17 Sending an Apple event Listing 6-18 An idle function æC line 20 of card 268 line 41 of card 268 line 22 of card 269 line 66 of card 269 line 8 of card 272 line 6 of card 273 line 7 of card 274 line 6 of card 275 line 39 of card 277 line 47 of card 281 line 16 of card 282 line 21 of card 283 line 48 of card 283 line 110 of card 285 line 25 of card 288 line 57 of card 288 line 64 of card 289 line 35 of card 291 æKY Program-To-Program Communications Toolbox.Sections æN About This Chapter About the PPC Toolbox Ports, Sessions, and Message Blocks Setting up Authenticated Sessions Using the PPC Toolbox PPC Toolbox Calling Conventions Specifying Port Names and Location Names Opening a Port Browsing for Ports Using the Program Linking Dialog Box Obtaining a List of Available Ports Preparing for a Session Initiating a PPC Session Receiving Session Requests Accepting or Rejecting Session Requests Exchanging Data During a PPC Session Reading Data From an Application Sending Data to an Application Ending a Session and Closing a Port Invalidating Users PPC Toolbox Routines The PPC Toolbox Parameter Block & Completion Routine Initializing the PPC Toolbox Using the Program Linking Dialog Box Obtaining a List of Ports Opening and Closing a Port Starting and Ending a Session Receiving, Accepting, and Rejecting a Session Reading and Writing Data Locating a Default User and Invalidating a User Summary of the PCC Toolbox Constants Data types Routines Result Codes Assembly-Language Information æC card 324 card 325 card 326 card 327 card 328 card 329 card 330 card 331 card 332 card 333 card 334 card 335 card 336 card 337 card 338 card 339 card 340 card 341 card 342 card 343 card 344 card 345 card 346 card 347 card 348 card 349 card 350 card 351 card 352 card 353 card 354 card 355 card 356 card 357 card 358 æKY Program-To-Program Communications Toolbox.Figures æN Figure 7-1 A PPC Toolbox session between two applications Figure 7-2 The Sharing Setup icon Figure 7-3 The Sharing Setup control panel Figure 7-4 The session termination alert box Figure 7-5 The users and groups dialog box Figure 7-6 The user termination alert box Figure 7-7 The guest dialog box Figure 7-8 The PPC Toolbox authentication process Figure 7-9 Database and spreadsheet applications using the PPC Toolbox Figure 7-10 Two Macintosh applications and their corresponding ports Figure 7-11 The PPC Toolbox and a dictionary service application Figure 7-12 The program linking dialog box Figure 7-13 The program linking dialog box without a zone list Figure 7-14 The user identity dialog box Figure 7-15 The incorrect password dialog box Figure 7-16 The invalid user name dialog box Figure 7-17 Transmitting message blocks Figure 7-18 The PPC Toolbox parameter blocks æC line 14 of card 326 line 3 of card 327 line 8 of card 327 line 15 of card 327 line 26 of card 327 line 31 of card 327 line 36 of card 327 line 45 of card 327 line 88 of card 328 line 9 of card 330 line 3 of card 331 line 10 of card 332 line 15 of card 332 line 16 of card 335 line 25 of card 335 line 32 of card 335 line 5 of card 338 line 28 of card 344 æKY Program-To-Program Communications Toolbox.Listings æN Listing 7-1 Initializing the PPC Toolbox using the PPCInit function Listing 7-2 Opening a PPC port Listing 7-3 Using a port filter function Listing 7-4 Browsing through dictionary service ports Listing 7-5 Using the IPCListPorts function to obtain a list of ports Listing 7-6 Using the StartSecureSession function to establish a session Listing 7-7 Initiating a session using the PPCStart function Listing 7-8 Using the PPCInform function to enable a port to receive sessions Listing 7-9 Completion routine for a PPCInform function Listing 7-10 Accepting a session request using the PPCAccept function Listing 7-11 Completion routine for a PPCAccept function Listing 7-12 Rejecting a session request using the PPCReject function Listing 7-13 Completion routine for a PPCReject function Listing 7-14 Using the PPCRead function to read data during a session Listing 7-15 Polling the ioResult field to determine if a PPCRead function has completed Listing 7-16 Using the PPCWrite function to write data during a session Listing 7-17 Polling the ioResult field to determine if a PPCWrite function has completed Listing 7-18 Ending a PPC session using the PPCEnd function Listing 7-19 Closing a PPC port using the PPCClose function Listing 7-20 Using the DeleteUserIdentity function to invalidate a user identity æC line 41 of card 328 line 6 of card 331 line 40 of card 332 line 74 of card 332 line 7 of card 333 line 44 of card 335 line 110 of card 335 line 6 of card 336 line 37 of card 336 line 13 of card 337 line 32 of card 337 line 51 of card 337 line 72 of card 337 line 10 of card 339 line 33 of card 339 line 8 of card 340 line 35 of card 340 line 6 of card 341 line 26 of card 341 line 14 of card 342 æKY Data Access Manager.Sections æN About This Chapter About the Data Access Manager The High-Level Interface Sending a Query Through the High-Level Interface Retrieving Data Through the High-Level Interface The Low-Level Interface Sending a Query Through the Low-Level Interface Retrieving Data Through the Low-Level Interface Comparison of the High-Level and Low-Level Interfaces Using the Data Access Manager Executing Routines Asynchronously General Guidelines for the User Interface Keep the User in Control Provide Feedback to the User Using the High-Level Interface Writing a Status Routine for High-Level Functions Using the Low-Level Interface Getting Information About Sessions in Progress Processing Query Results Getting Query Results Converting Query Results to Text Creating a Query Document User Interface Guidelines for Query Documents Contents of a Query Document Query Records and Query Resources Query Records Query Resources Writing a Query Definition Function Data Access Manager Routines Asynchronous Execution of Routines Initializing the Data Access Manager High-Level Interface Handling Query Documents Handling Query Results Low-Level Interface Controlling the Session Sending and Executing Queries Retrieving Results Installing and Removing Result Handlers Summary of the Data Access Manager Constants Data Types Routines Result Codes Assembly-Language Information æC card 359 card 360 card 361 card 362 card 363 card 364 card 365 card 366 card 367 card 368 card 369 card 370 card 371 card 372 card 373 card 374 card 375 card 376 card 377 card 378 card 379 card 380 card 381 card 382 card 383 card 384 card 385 card 386 card 387 card 388 card 389 card 390 card 391 card 392 card 393 card 394 card 395 card 396 card 397 card 398 card 399 card 400 card 401 card 402 card 403 æKY Data Access Manager.Figures æN Figure 8-1 A connection with a database Figure 8-2 Using high-level Data Access Manager routines Figure 8-3 Using low-level Data Access Manager routines Figure 8-4 A flowchart of a session using the high-level interface Figure 8-5 A flowchart of a session using the low-level interface Figure 8-6 A query document dialog box Figure 8-7 Function of a query document æC line 9 of card 360 line 25 of card 361 line 21 of card 364 line 7 of card 373 line 7 of card 375 line 23 of card 382 line 33 of card 382 æKY Data Access Manager.Tables æN Table 8-1 Data types defined by the Data Access Manager æC line 42 of card 378 æKY Data Access Manager.Listings æN Listing 8-1 Using the high-level interface Listing 8-2 A sample status routine Listing 8-3 Sending a query fragment Listing 8-4 Using the low-level interface Listing 8-5 A result handler Listing 8-6 A query definition function æC line 128 of card 373 line 185 of card 374 line 86 of card 375 line 171 of card 375 line 62 of card 379 line 25 of card 386 æKY Finder Interface.Sections æN About This Chapter About the Finder Interface Finder-Related Resources Creators, File Types, and the Signature Resource Icon Resources File Reference Resources The Bundle Resource The Size Resource Messages When the Finder Can’t Find Your Application Version Resources How and When the Finder Launches Your Application Finder-Related Changes to User Interface Stationery Pads Edition Icons Customized Icons Aliases Resolving Alias Files Desk Accessories Fonts, Sounds, and Other Movable Resources Balloon Help for Icons Finder Information in the Volume Catalog The System Folder & Related Directories Folder Organization Finding Directories The Desktop Database History of the Desktop Database Using the Desktop Database Desktop Manager Routines Locating and Opening the Desktop Database Reading the Desktop Database Adding to the Desktop Database Deleting Entries From the Desktop Database Manipulating the Desktop Database Itself Summary of the Finder Interface Constants Data Types Routines Result Codes Assembly-Language Information æC card 404 card 405 card 406 card 407 card 408 card 409 card 410 card 411 card 412 card 413 card 414 card 415 card 416 card 417 card 418 card 419 card 420 card 421 card 422 card 423 card 424 card 425 card 426 card 427 card 428 card 429 card 430 card 431 card 432 card 433 card 434 card 435 card 436 card 437 card 438 card 439 card 440 card 441 card 442 æKY Finder Interface.Figures æN Figure 9-1 Default large black-and-white icons Figure 9-2 An application icon and its mask Figure 9-3 The ResEdit view of an icon and its mask Figure 9-4 Examples of document icons Figure 9-5 Linking 'ICN#' and 'FREF' resources in a 'BNDL' resource Figure 9-6 The default application-unavailable alert box Figure 9-7 Application-unavailable box specifying an application’s name Figure 9-8 Application-unavailable alert box with a customized message Figure 9-9 Application-unavailable box for 'TEXT' and 'PICT' documents Figure 9-10 The version data in the information window Figure 9-11 Default and customized help balloons for application icons Figure 9-12 The System Folder and related folders æC line 35 of card 408 line 42 of card 408 line 47 of card 408 line 105 of card 408 line 60 of card 410 line 5 of card 412 line 23 of card 412 line 40 of card 412 line 45 of card 412 line 35 of card 413 line 5 of card 423 line 13 of card 425 æKY Finder Interface.Listings æN Listing 9-1 'ICN#' resources for an application and its documents Listing 9-2 Using file reference resources Listing 9-3 Using a bundle resource Listing 9-4 Using the ResolveAliasFile function to open a file Listing 9-5 Creating a help balloon resource for an application icon æC line 53 of card 408 line 6 of card 409 line 21 of card 410 line 63 of card 420 line 11 of card 423 æKY Control Panels.Sections æN About This Chapter About Control Panels Writing Control Panel Files About the Monitors Control Panel Designing an Extension The 'card' Resource The 'mntr' Resource The Monitor Function Messages to the Monitor Function The 'RECT' Resource The 'DITL' Resource The 'ICON' and 'cicn' Resources The 'vers' Resources The 'STR#' Resource The 'gama' Resources The 'FREF', 'BNDL', Icon Family, & Signature Resources The 'INIT' Resource A Sample of an Extension to the Monitors Control Panel Adding a Monitors Extension File Summary of the Monitors Extension File Constants Application-Defined Routine æC card 443 card 444 card 445 card 446 card 447 card 448 card 449 card 450 card 451 card 452 card 453 card 454 card 455 card 456 card 457 card 458 card 459 card 460 card 461 card 462 card 463 card 464 æKY Control Panels.Figures æN Figure 10-1 The Monitors control panel Figure 10-2 An Options dialog box for a Monitors control panel Figure 10-3 An Options dialog box with superuser controls æC line 18 of card 446 line 23 of card 446 line 6 of card 453 æKY Control Panels.Listings æN Listing 10-1 Sample of an extension to the Monitors control panel Listing 10-2 Resources for a file that extends the Monitors control panel æC line 10 of card 460 line 365 of card 460 æKY Help Manager.Sections æN About This Chapter About the Help Manager Help Balloon Display Default Help Balloons for Menus, Windows, and Icons Using the Help Manager Providing Text or Pictures for Help Balloons Defining the Help Balloon Content Using Clear, Concise Phrases Using Active Constructions Using Parallel Structure Using Consistent Terminology Defining the Help Balloon Position Specifying the Format for Help Balloon Content Specifying Options in Help Resources Providing Help Balloons for Menus Providing Help Balloons in Dialog Boxes & Alert Boxes Providing Help Balloons for Window Content Help Balloons in Static Windows Help Balloons in Dynamic Windows Overriding Help Balloons for Application Icons Overriding Other Default Help Balloons Adding Your Own Menu Items to the Help Menu Writing Your Own Balloon Definition Function Help Manager Routines Determining Whether Help Is Enabled Determining Whether a Help Balloon Is Showing Displaying and Removing Help Balloons Displaying a Help Balloon Using Your Own Menu Definition Procedure Removing a Help Balloon Using Your Own Tip Function Adding Items to the Help Menu Getting and Setting the Font Name and Size Getting and Setting Information for Help Resources Getting the Dimensions of a Help Balloon Getting the Content of a Help Balloon Summary of the Help Manager Constants Data Types Routines Result Codes Assembly-Language Information æC card 465 card 466 card 467 card 468 card 469 card 470 card 471 card 472 card 473 card 474 card 475 card 476 card 477 card 478 card 479 card 481 card 482 card 483 card 484 card 485 card 486 card 487 card 488 card 489 card 490 card 491 card 492 card 493 card 494 card 495 card 496 card 497 card 498 card 499 card 500 card 501 card 502 card 503 card 504 card 505 card 506 card 507 æKY Help Manager.Figures æN Figure 11-1 The Help menu for the Finder Figure 11-2 A help balloon Figure 11-3 The tip and hot rectangle for a help balloon Figure 11-4 Standard balloon positions and their variation codes Figure 11-5 Alternate positions of a help balloon Figure 11-6 Default help balloons for the window frame Figure 11-7 Default help balloons for the Apple and Help menus Figure 11-8 Default help balloons for application and document icons Figure 11-9 Help balloons for different states of the Cut command Figure 11-10 Help balloons for a changing menu item Figure 11-11 A help balloon in a modal dialog box Figure 11-12 Static and dynamic windows Figure 11-13 A tool palette with a help balloon Figure 11-14 A help balloon for a dialog box with a title Figure 11-15 Default and customized help balloons for an application icon Figure 11-16 The Help menu with two appended menu items æC line 17 of card 466 line 23 of card 467 line 30 of card 467 line 41 of card 467 line 53 of card 467 line 45 of card 468 line 58 of card 468 line 65 of card 468 line 37 of card 479 line 64 of card 479 line 223 of card 481 line 7 of card 482 line 137 of card 483 line 187 of card 483 line 52 of card 485 line 7 of card 487 æKY Help Manager.Listings æN Listing 11-1 A partial menu help resource Listing 11-2 The missing items component in a menu help resource Listing 11-3 Corresponding 'hmnu' and 'STR#' resources Listing 11-4 Using HMCompareItem for a changing menu item Listing 11-5 A dialog item list and its help resource Listing 11-6 Corresponding 'hwin' and 'hrct' resources for a tool palette Listing 11-7 Specifying help for windows with an 'hwin' resource Listing 11-8 Using HMShowBalloon to display help balloons Listing 11-9 Creating a help balloon resource for an application icon Listing 11-10 Overriding default help balloons Listing 11-11 A sample menu help resource for items in the Help menu æC line 85 of card 479 line 226 of card 479 line 321 of card 479 line 18 of card 479 line 124 of card 481 line 143 of card 483 line 193 of card 483 line 219 of card 484 line 59 of card 485 line 79 of card 486 line 36 of card 487 æKY Font Manager.Sections æN About This Chapter About The Font Manager Font Terminology Font Measurements Font Scaling How the Font Manager Renders TrueType Fonts Using the Font Manager Adding Font Sizes and Names to the Menu Storing a Font Name in a Document Using TrueType Fonts in Preference to Bitmapped Fonts Preserving the Glyph’s Shape Font Manager Routines Choosing TrueType Fonts Over Bitmapped Fonts Scaling Fonts Erasing the Font Manager’s Memory Caches Summary of the Font Manager Constants Routines æC card 508 card 509 card 510 card 511 card 512 card 513 card 514 card 515 card 516 card 517 card 518 card 519 card 520 card 521 card 522 card 523 card 524 card 525 æKY Font Manager.Figures æN Figure 12-1 The standard Roman character set Figure 12-2 Terms for font measurements Figure 12-3 The ascent line and maximum y-value Figure 12-4 A comparison of scaled TrueType and bitmapped fonts Figure 12-5 A glyph stretched horizontally Figure 12-6 A glyph stretched vertically Figure 12-7 A glyph condensed horizontally Figure 12-8 The effect of an off-curve point on two Bézier curves Figure 12-9 An outline with points on and off the curve Figure 12-10 A curve with consecutive off-curve points Figure 12-11 An outline glyph Figure 12-12 An unmodified outline glyph at a small point size Figure 12-13 An instructed outline glyph Figure 12-14 A sample Size menu and font size dialog box Figure 12-15 The difference between a scaled glyph and a preserved glyph æC line 21 of card 510 line 3 of card 511 line 20 of card 511 line 5 of card 512 line 14 of card 512 line 21 of card 512 line 26 of card 512 line 13 of card 513 line 18 of card 513 line 23 of card 513 line 28 of card 513 line 39 of card 513 line 44 of card 513 line 30 of card 515 line 7 of card 518 æKY Font Manager.Listings æN Listing 12-1 Checking a font family ID against the font name æC line 6 of card 516 æKY Resource Manager.Sections æN About This Chapter Resources Resource Types Resource IDs Definition Procedures Font Families and Scripts Resources in the System File System Icons Document and Application Icons Folder Icons System Folder Icons Desktop Icons Standard File Package Icons User Information Resources Packages Function Key Resources Using the Resource Manager Using Partial Resources Creating and Opening Resource Files Storing Fonts in a Resource Fork Resource Manager Routines Creating Resource Files Opening Resource Files Reading and Writing Partial Resources Summary of the Resource Manager Constants Routines Result Codes Assembly-Language Information æC card 526 card 527 card 528 card 529 card 530 card 531 card 532 card 533 card 534 card 535 card 536 card 537 card 538 card 539 card 540 card 541 card 542 card 543 card 544 card 545 card 546 card 547 card 548 card 549 card 550 card 551 card 552 card 553 card 554 æKY Resource Manager.Tables æN Table 13-1 Resource types available for your application’s use Table 13-2 Resource types reserved for the Operating System’s use æC line 7 of card 528 line 105 of card 528 æKY Resource Manager.Listings æN Listing 13-1 Using partial resource calls æC line 16 of card 543 æKY Worldwide Software Overview.Sections æN About this Chapter About Worldwide Software The Graphic Representation of Languages Localized Versions of the Macintosh System Software Multiple Script Systems and Multiple Languages Identifying Scripts, Languages, and Regions About the Script Management System About the Script Manager Local and Global Variables Style Runs and Higher-Level Text Organization Tokens Date Conversion Geographic Information Number Conversion About the International Utilities Package About the International and Keyboard Resources About the Macintosh Script Systems Script Management System and Related Components Worldwide Control Panels and Desk Accessory Installing & Removing Script Systems, Keyboards & Fonts Using the Keyboard Menu Selecting Keyboard Layouts Distinguishing Scripts Keyboards Fonts Localization Sorting Primary or Secondary Order Expansion Contraction Ignorable Characters Exceptional Words Formats Date and Time Currency and Measurement Calendars Numbers An Introduction to Scripts Character Representation Text Direction Contextual Forms Diacritical Marks Uppercase and Lowercase Characters Character Reordering Word Demarcation Alignment and Justification of Text Representing Scripts on the Macintosh Character Set Encoding Character Input Composition Rules Text Manipulation Text Rendering Using the Script Manager Determining the Features of the Script Manager Initializing the Script Manager Creating Simple Script Systems Calling the Script Manager Overview of the Script Manager Routines Checking and Modifying Global and Local Variables Accepting Implicit Script Codes Verbs for GetScript and SetScript Verbs for GetEnvirons and SetEnvirons Checking and Setting System Variables Setting the Active Keyboard Script Obtaining Script Information Obtaining Character Information Manipulating Text Drawing and Editing Text Formatting Text Modifying Text Substituting Text Truncating Text Lexically Interpreting Different Scripts Date and Time Utilities Converting Worldwide Dates and Times Converting Long Dates Modifying and Verifying Date and Time Records Reading and Storing Locations Number Utilities Converting to and From Canonical Number Formats Working With Formatted Numbers Script Manager Routines Localizing Word Selection and Line Break Tables Defining Word Boundaries and Line Breaks Determining Word Selection: An Example Optimized Word Break Tables Truncating Text Substituting Text Substituting and Truncating Text Converting Case and Stripping Diacritical Marks Handling Justified Text Providing for Spacing Between Multiple Style Runs Justifying Text on the Roman Script System Using Intl Utilities Package Routines International Utilities Routine Overview Comparing Strings Modifying the Standard String Comparison Facilitating Interscript Sorting Order Accessing the International Resources Localizing Dates, Times, and Metric Information International Utilities Package Routines Script and Language Codes Manipulating the 'itl2' and 'itl4' Resources Specifying Resource Handles Explicitly Determining Interscript Sorting Order Using Intl and Keyboard Resources Enhancements to International Resources The 'itlc' Resource The 'itlm' Resource The 'itlb' Resource The 'itl0' Resource The 'itl1' Resource The 'itl2' Resource The 'itl2' Resource Header The 'itl4' Resource Keyboard Types and Modifier Bits The 'KCHR' Resource The 'kcs#', 'kcs4', and 'kcs8' Resources The 'KSWP' Resource The 'itlk' Resource Keys Caps and the 'KCAP' Resource Dead-Key Feedback The 'KCAP' Resource Localizing to Other Languages and Regions Using Resources Text and Dialog Translation Tips Adapting Text Operations Using Fonts Avoiding Special Character Codes as Delimiters Using the Standard Roman Character Set Adapting Keyboard Equivalents Modifying the Representation of Dates, Times, & Numbers Writing Software for Other Scripts Working With Fonts Working With Character Codes Working With Text Direction Synchronizing Keyboards and Fonts Handling Numbers Identifying Keywords and Tokens Possible Printing Problems Summary of the Script Manager Constants Data Types Routines Assembly-Language Information Summary of the Intl Utilities Package Constants Data Types Routines Assembly-Language Information Summary of International Resources Data Types æC card 555 card 556 card 557 card 558 card 559 card 560 card 561 card 562 card 563 card 564 card 565 card 566 card 567 card 568 card 569 card 570 card 571 card 572 card 573 card 574 card 575 card 576 card 577 card 578 card 579 card 580 card 581 card 582 card 583 card 584 card 585 card 586 card 587 card 588 card 589 card 590 card 591 card 592 card 593 card 594 card 595 card 596 card 597 card 598 card 599 card 600 card 601 card 602 card 603 card 604 card 605 card 606 card 607 card 608 card 609 card 610 card 611 card 612 card 613 card 614 card 615 card 616 card 617 card 618 card 619 card 620 card 621 card 622 card 623 card 624 card 625 card 626 card 627 card 628 card 629 card 630 card 631 card 632 card 633 card 634 card 635 card 636 card 637 card 638 card 639 card 640 card 641 card 642 card 643 card 644 card 645 card 646 card 647 card 648 card 649 card 650 card 651 card 652 card 653 card 654 card 655 card 656 card 657 card 658 card 659 card 660 card 661 card 662 card 663 card 664 card 665 card 666 card 667 card 668 card 669 card 670 card 671 card 672 card 673 card 674 card 675 card 676 card 677 card 678 card 679 card 680 card 681 card 682 card 683 card 684 card 685 card 686 card 687 card 688 card 689 card 690 card 691 card 692 card 693 card 694 card 695 card 696 card 698 card 699 card 700 card 701 card 702 card 703 card 704 card 705 card 706 card 707 æKY Worldwide Software Overview.Figures æN Figure 14-1 The script, language, and region hierarchy Figure 14-2 Types of script systems Figure 14-3 The components of the Macintosh Script Management System Figure 14-4 Worldwide control panels and desk accessory Figure 14-5 Default icons for keyboards, fonts, and scripts Figure 14-6 The Keyboard menu Figure 14-7 Distinguishing scripts with resource ID's for script codes 0–32 Figure 14-8 Keyboard translation Figure 14-9 Scripts Figure 14-10 Alphabetic, syllabic, and ideographic representations Figure 14-11 Three text directions Figure 14-12 Contextual forms in cursive English Figure 14-13 Stand-alone and contextual forms in Arabic Figure 14-14 A ligature in Roman text Figure 14-15 Ligatures in Arabic text Figure 14-16 Character reordering in Devanagari (for the word hindi ) Figure 14-17 Backing-store and display order Figure 14-18 Calling routines implemented by script system Figure 14-19 Calling the Script Manager routines Figure 14-20 Forward operation of the state machine for word selection Figure 14-21 NFindWord header and class tables Figure 14-22 NFindWord state table Figure 14-23 Format of NFindWord action code Figure 14-24 Roman word selection state transitions Figure 14-25 Justification in Roman text Figure 14-26 The effects of the Roman justification routines Figure 14-27 The 'itl2' resource header Figure 14-28 Inside the 'KCHR' resource Figure 14-29 Format of entries in the 'KSWP' resource Figure 14-30 The 'itlk' resource entries Figure 14-31 Key Caps display of dead keys with Option key pressed Figure 14-32 Display of completer keys after pressing circumflex dead key Figure 14-33 Extracting blocks of Roman text æC line 17 of card 560 line 5 of card 571 line 3 of card 572 line 19 of card 572 line 3 of card 574 line 27 of card 575 line 8 of card 577 line 17 of card 578 line 5 of card 592 line 8 of card 593 line 7 of card 594 line 3 of card 595 line 8 of card 595 line 13 of card 595 line 18 of card 595 line 5 of card 598 line 3 of card 606 line 17 of card 611 line 22 of card 611 line 24 of card 638 line 36 of card 638 line 41 of card 638 line 46 of card 638 line 98 of card 639 line 26 of card 647 line 81 of card 647 line 9 of card 669 line 19 of card 671 line 5 of card 673 line 8 of card 674 line 3 of card 676 line 8 of card 676 line 32 of card 688 æKY Worldwide Software Overview.Tables æN Table 14-1 GetScript and SetScript verbs Table 14-2 Verbs for GetEnvirons and SetEnvirons Table 14-3 Verbs for the KeyScript procedure Table 14-4 U.S. word selection algorithm Table 14-5 Occurrence of word breaks in various character sequences Table 14-6 Significance of the state numbers in the Roman word selection Table 14-7 U.S. word select transition table for forward processing Table 14-8 Proportions of slop value to be distributed Table 14-9 The international and keyboard resources Table 14-10 Script, language, and region codes Table 14-11 The keyboard types Table 14-12 The keyboard modifier bits Table 14-13 Changes in handling 'KCHR' (0) key combinations Table 14-14 Changes in 'KCHR' dead-key completers Table 14-15 Keyboard color icon types and standard icon equivalents æC line 8 of card 615 line 11 of card 616 line 12 of card 618 line 9 of card 639 line 54 of card 639 line 72 of card 639 line 106 of card 639 line 31 of card 646 line 18 of card 660 line 81 of card 663 line 4 of card 670 line 31 of card 670 line 47 of card 671 line 79 of card 671 line 9 of card 672 æKY Worldwide Software Overview.Listings æN Listing 14-1 Obtaining optimized word break tables Listing 14-2 Substituting and truncating text Listing 14-3 Distributing slop value among style runs Listing 14-4 Multiscript mapping and sorting Listing 14-5 International date and time information Listing 14-6 Physical layout of keyboards Listing 14-7 Making keyboard equivalents work with multiple scripts æC line 4 of card 640 line 4 of card 643 line 61 of card 646 line 28 of card 663 line 48 of card 666 line 8 of card 677 line 4 of card 685 æKY TextEdit.Sections æN About This Chapter About TextEdit Mixed-Directional Text Highlighting Mouse-Down Regions Dual Carets Caret Movement Across Direction Boundaries Font and Keyboard Synchronization Double-Byte Characters Vertical Movement of the Caret Arrow Key Actions for Selected Text Caret Position at Line Ends Word Selection and Line Breaks Accurate Line Measurement TextEdit and TrueType Fonts Using TextEdit Determining the Version of TextEdit Customizing TextEdit’s Features Measuring the Width of Components of a Line Defining Word Boundaries Outline Highlighting, Text Buffering, & Inline Input Setting Alignment for Right-to-Left Directional Scripts Using WordRedraw for Line Calculations Using the lineStarts Array to Determine Line Length Using TextEdit’s Default Click Procedure TextEdit Routines Using Outline Highlighting, Text Buffering, & Inline Input Outline Highlighting Text Buffering Inline Input Customizing TextEdit Replacing the End-of-Line Routine Replacing the Measuring Routines Replacing the Drawing Routine Replacing the Hit Test Routine Replacing the Word Breaking Routine Backspacing to the Beginning of a Style Determining the Position of an Ambiguous Offset Toggling a Style Determining Styles Across a Selection Setting Styles in TextEdit’s Scrap Record Determining the Number of Styles TextEdit Data Structures Summary of TextEdit Constants Data Type Routines Global Variables Assembly-Language Information æC card 708 card 709 card 710 card 711 card 712 card 713 card 714 card 715 card 716 card 717 card 718 card 719 card 720 card 721 card 722 card 723 card 724 card 725 card 726 card 727 card 728 card 729 card 730 card 731 card 732 card 733 card 734 card 735 card 736 card 737 card 738 card 739 card 740 card 741 card 742 card 743 card 744 card 745 card 746 card 747 card 748 card 749 card 750 card 751 card 752 card 753 card 754 card 755 card 756 æKY TextEdit.Figures æN Figure 15-1 A right-to-left primary line direction Figure 15-2 The display order Figure 15-3 The backing-store order Figure 15-4 Different levels of runs in a line of text Figure 15-5 Discontinuous highlighting display Figure 15-6 Highlighting mixed-directional text Figure 15-7 Mouse-down region specifics Figure 15-8 Dual carets in mixed-directional text Figure 15-9 Pasting styled text Figure 15-10 Dual carets at a direction boundary Figure 15-11 Caret movement across a direction boundary Figure 15-12 Font and keyboard script synchronization Figure 15-13 The caret position at line end Figure 15-14 Word breaks for word selection Figure 15-15 A line break with multiple scripts installed Figure 15-16 A character offset at a line break Figure 15-17 An initial selection before TESetStyle is called Figure 15-18 The result of calling TESetStyle to toggle with a bold style Figure 15-19 The result of calling TESetStyle to toggle with an italic style Figure 15-20 The TextEdit data structures æC line 5 of card 710 line 14 of card 710 line 26 of card 710 line 33 of card 710 line 5 of card 711 line 12 of card 711 line 7 of card 712 line 5 of card 713 line 10 of card 713 line 21 of card 713 line 12 of card 714 line 3 of card 715 line 7 of card 719 line 7 of card 720 line 12 of card 720 line 12 of card 745 line 13 of card 746 line 18 of card 746 line 23 of card 746 line 47 of card 750 æKY TextEdit.Tables æN Table 15-1 Constants for the just parameter of TESetJust æC line 18 of card 729 æKY TextEdit.Listings æN Listing 15-1 Marking the Style menu items so they correspond to the current Listing 15-2 Determining the font, face, size, and color of the current selection æC line 14 of card 747 line 47 of card 747 æKY Graphics Overview.Sections æN About This Chapter About Macintosh Graphics The Components of Macintosh Graphics QuickDraw The Interface The Video Card and Screen The Major Data Structures The RGB Color Record Color Collections The Pixel Map Record Port Characteristics: The Color GrafPort Record Device Characteristics: The Graphics Device Record Graphics Initialization The Graphics Path How Indexed Pixels Work How Direct Pixels Work Determining the QuickDraw Version What Else to Read Summary of Graphics Data Types Data Types æC card 757 card 758 card 759 card 760 card 761 card 762 card 763 card 764 card 765 card 766 card 767 card 768 card 769 card 770 card 771 card 772 card 773 card 774 card 775 card 776 æKY Graphics Overview.Figures æN Figure 16-1 Macintosh graphics chapters Figure 16-2 QuickDraw and the graphics managers Figure 16-3 Initializing Macintosh graphics Figure 16-4 The indexed pixel path Figure 16-5 The direct pixel path æC line 11 of card 758 line 5 of card 761 line 3 of card 769 line 3 of card 771 line 3 of card 772 æKY Color QuickDraw.Sections æN About This Chapter About Color QuickDraw Direct Pixels Pixel Map Record Extensions Direct Pixel Values Writing Compatible Graphics Applications Using Color QuickDraw Manipulating Pixel Map Images Copying With Masks Colorizing Transfer Modes Dithering Resizing Images Luminance Mapping Image Resolution Displaying Variable-Resolution Pixel Maps and Pictures Exporting Pixel Map Records Converting a Bitmap to a Region Determining Whether Drawing Is Complete Extensions to the Version 2 Picture Format Font Name Line Justification Direct Pixel Images Sample Extended Version 2 Picture Color QuickDraw Routines Creating an Extended Version 2 Picture Creating Regions From Bitmaps Copying Pixel Map Images Determining Whether QuickDraw Has Finished Drawing Reporting Data Structure Changes Obtaining Intermediate Colors Interpreting New QDError Result Codes Using a Custom Color Search Function Summary of Color QuickDraw Constants Data Types Routines Result Codes æC card 777 card 778 card 779 card 780 card 781 card 782 card 783 card 784 card 785 card 786 card 787 card 788 card 789 card 790 card 791 card 792 card 793 card 794 card 795 card 796 card 797 card 798 card 799 card 800 card 801 card 802 card 803 card 804 card 805 card 806 card 807 card 808 card 809 card 810 card 811 card 812 card 813 card 814 æKY Color QuickDraw.Figures æN Figure 17-1 A 32-bit direct pixel Figure 17-2 A 16-bit direct pixel Figure 17-3 Converting a 16-bit direct pixel to a 32-bit direct pixel Figure 17-4 Converting a 48-bit RGB color to a 32-bit direct pixel Figure 17-5 Converting a 48-bit RGB color to a 16-bit direct pixel Figure 17-6 Converting a 48-bit RGB color to an 8-bit indexed pixel Figure 17-7 Converting a 32-bit pixel to a 48-bit RGB color Figure 17-8 Converting a 16-bit pixel to a 48-bit RGB color Figure 17-9 Converting an 8-bit indexed pixel to a 48-bit RGB color Figure 17-10 Copying pixel maps with CopyBits Figure 17-11 Copying pixel maps with CopyMask Figure 17-12 Copying pixel maps with CopyDeepMask æC line 9 of card 781 line 20 of card 781 line 27 of card 781 line 36 of card 781 line 41 of card 781 line 46 of card 781 line 51 of card 781 line 56 of card 781 line 61 of card 781 line 3 of card 785 line 8 of card 785 line 14 of card 785 æKY Color QuickDraw.Tables æN Table 17-1 The default color tables for gray-scale devices Table 17-2 The default color tables for color devices Table 17-3 The new version 2 picture opcodes Table 17-4 Version 2 picture example æC line 11 of card 790 line 26 of card 790 line 16 of card 796 line 4 of card 800 æKY Picture Utilities Package.Sections æN About This Chapter About the Picture Utilities Package Using the Picture Utilities Package Getting Color Information Surveying Multiple Pixel Maps or Pictures Storing Information: The Picture Information Record Picture Utilities Package Routines Collecting Information From a Single Image Collecting Information From Multiple Images Creating Custom Color-Sampling Methods Summary of the Picture Utilities Package Constants Data Types Routines Result Codes Assembly-Language Information æC card 815 card 816 card 817 card 818 card 819 card 820 card 821 card 822 card 823 card 824 card 825 card 826 card 827 card 828 card 829 card 830 æKY Color Picker Package.Sections æN About This Chapter About the Color Picker Package Color Models The RGB Model The CMYK Model The HLS and HSV Models Color Models in the Dialog Box Using the Color Picker Package Presenting the Color Picker Dialog Box Using Conversion Facilities Color Picker Package Routines Displaying the Color Picker Dialog Box Converting Between Color Models Converting Between SmallFract and Fixed Values Summary of the Color Picker Package Constants Data Types Routines Assembly-Language Information æC card 831 card 832 card 833 card 834 card 835 card 836 card 837 card 838 card 839 card 840 card 841 card 842 card 843 card 844 card 845 card 846 card 847 card 848 card 849 æKY Color Picker Package.Figures æN Figure 19-1 The Color Picker dialog box Figure 19-2 The RGB color cube Figure 19-3 Getting to pink Figure 19-4 Cyan, magenta, and yellow on the color cube Figure 19-5 The HLS/HSV color cone æC line 7 of card 832 line 16 of card 834 line 21 of card 834 line 13 of card 835 line 5 of card 836 æKY Palette Manager.Sections æN About This Chapter About the Palette Manager Palettes Color Usage Categories Changing the Color Environment Restoring the Color Environment Using the Palette Manager Working With Color Usage Categories Courteous Colors Tolerant Colors Animated Colors Displaying Animated Colors on Direct Devices Explicit Colors Inhibited Colors Combined Usage Categories Creating Palettes Assigning Colors to a Palette Creating a Palette in a Resource File Assigning a Default Palette to an Application Linking a Color Table to a Palette Associating One Palette With Many Ports Palette Manager Routines Initializing the Palette Manager Initializing and Allocating Palettes Interacting With the Window Manager Drawing With Color Palettes Animating Color Tables Manipulating Palettes and Color Tables Manipulating Palette Entries Summary of the Palette Manager Constants Data Types Routines æC card 850 card 851 card 852 card 853 card 854 card 855 card 856 card 857 card 858 card 859 card 860 card 861 card 862 card 863 card 864 card 865 card 866 card 867 card 868 card 869 card 870 card 871 card 872 card 873 card 874 card 875 card 876 card 877 card 878 card 879 card 880 card 881 card 882 æKY Palette Manager.Figures æN Figure 20-1 A courteous palette æC line 5 of card 858 æKY Palette Manager.Listings æN Listing 20-1 A palette ('pltt') resource Listing 20-2 A multi-use palette æC line 4 of card 867 line 51 of card 867 æKY Graphics Devices Manager.Sections æN About This Chapter About the Graphics Devices Manager Offscreen Graphics Using the Graphics Devices Manager Offscreen Graphics World Flags Example of Offscreen Graphics Code Advanced Features The Graphics Device Record The 'scrn' Resource Setting a Device's Pixel Depth Graphics Devices Manager Routines High-Level Routines Creating a Graphics World Working With a Graphics World’s Pixel Map Updating the Graphics World Setting and Retrieving the Graphics World Disposing of a Graphics World Low-Level Routines Supporting the Offscreen Graphics World Managing the Graphics Device Record Summary of the Graphics Manager Constants Data Types Routines Global Variables Result Codes Assembly-language Information æC card 883 card 884 card 885 card 886 card 887 card 888 card 889 card 890 card 891 card 892 card 893 card 894 card 895 card 896 card 897 card 898 card 899 card 900 card 901 card 902 card 903 card 904 card 905 card 906 card 907 card 908 card 909 æKY Graphics Devices Manager.Listings æN Listing 21-1 Sample offscreen graphics world æC line 4 of card 888 æKY Sound Manager.Sections æN About This Chapter About the Sound Manager Introduction to Sound Sound Synthesizers The Square-Wave Synthesizer The Wave-Table Synthesizer The Sampled Sound Synthesizer Sound Commands Sound Channels Multiple Channels of Sound Sound Compression and Expansion Continuous Play From Disk Sound Recording Sound Storage Formats Sound Resources The Format 1 'snd ' Resource The Format 2 'snd ' Resource Sound Files Chunk Organization and Data Types The Form Chunk The Format Version Chunk The Common Chunk The Sound Data Chunk Reading and Writing Sound Files Using the Sound Manager Playing 'snd ' Resources Allocating Sound Channels Initializing Sound Channels Releasing Sound Channels Determining Features of Synthesizers Playing Frequencies Playing Sampled Sounds Installing Voices Into Channels Manipulating a Sound That Is Playing Flushing Sound Channels Pausing and Restarting Sound Channels Synchronizing Sound Channels Managing the CPU Load Producing an Alert Sound Compressing and Expanding Sounds Playing Sampled Sounds From Files Playing an 'snd ' Resource From Disk Playing a File From Disk Playing Selections Recording Sounds Through the Sound Input Dialog Box Recording Sounds Directly From a Device Defining a Sound Input Completion Routine Defining an Interrupt Routine Getting and Setting Sound Input Device Information Obtaining Information About Sound Features Obtaining Information About Available Sound Features Obtaining Version Information Obtaining Information About a Single Sound Channel Obtaining Information About All Sound Channels Using Double Buffers Setting Up Double Buffers Writing a Doubleback Procedure Specifying Callback Routines Sound Manager Routines Playing Sound Resources Allocating and Releasing Sound Channels Linking Synthesizers to Sound Channels Sending Commands to a Sound Channel Obtaining Information Playing From Disk Managing Double Buffers Compressing and Expanding Audio Data Recording Sounds Manipulating Sound Input Devices Opening and Closing Sound Input Devices Recording Sounds Directly From Sound Input Devices Manipulating Device Settings Constructing Sound Resource and File Headers Registering Sound Input Devices Converting Between Milliseconds and Bytes Summary of the Sound Manager Constants Data Types Routines Application-Defined Routines Result Codes Assembly-Language Information æC card 910 card 911 card 912 card 913 card 914 card 915 card 916 card 917 card 918 card 919 card 920 card 921 card 922 card 923 card 924 card 925 card 926 card 927 card 928 card 929 card 930 card 931 card 932 card 933 card 934 card 935 card 936 card 937 card 938 card 939 card 940 card 941 card 942 card 943 card 944 card 945 card 946 card 947 card 948 card 949 card 950 card 951 card 952 card 953 card 954 card 955 card 956 card 957 card 958 card 959 card 960 card 961 card 962 card 963 card 964 card 965 card 966 card 967 card 968 card 969 card 970 card 971 card 972 card 973 card 974 card 975 card 976 card 977 card 978 card 979 card 980 card 981 card 982 card 983 card 984 card 985 card 986 card 987 card 988 card 989 card 990 card 991 æKY Sound Manager.Figures æN Figure 22-1 The position of the Sound Manager Figure 22-2 Bypassing the command queue Figure 22-3 Mixing multiple channels of sampled sound Figure 22-4 A graph of a wave table Figure 22-5 The Sound control panel Figure 22-6 The sound recording dialog box Figure 22-7 The structure of 'snd ' resources Figure 22-8 The location of the data offset bit Figure 22-9 The general structure of a chunk Figure 22-10 Interleaving stereo sample points Figure 22-11 A sample AIFF-C file æC line 11 of card 912 line 16 of card 912 line 23 of card 912 line 8 of card 915 line 5 of card 922 line 16 of card 922 line 18 of card 924 line 25 of card 924 line 3 of card 928 line 44 of card 932 line 5 of card 933 æKY Sound Manager.Tables æN Table 22-1 Audio compression and expansion options Table 22-2 AIFF and AIFF-C capabilities Table 22-3 MIDI values Table 22-4 Sample rates Table 22-5 Sound input device information selectors Table 22-6 Sound commands Table 22-7 The sound header format used by SetupSndHeader æC line 32 of card 920 line 14 of card 927 line 42 of card 940 line 98 of card 941 line 79 of card 958 line 30 of card 972 line 13 of card 982 æKY Sound Manager.Listings æN Listing 22-1 A format 1 'snd ' resource Listing 22-2 A restructured format 1 'snd ' resource Listing 22-3 A format 1 'snd ' resource containing sampled sound data Listing 22-4 A resource specification Listing 22-5 Resource specification for the Simple Beep Listing 22-6 A format 2 'snd ' resource Listing 22-7 Playing an 'snd ' resource with SndPlay Listing 22-8 Using low-level Sound Manager routines Listing 22-9 Creating a sound channel Listing 22-10 Using the availableCmd command Listing 22-11 Using the versionCmd command Listing 22-12 Using the freqDurationCmd command Listing 22-13 An 'snd ' resource containing compressed sound data Listing 22-14 Halving the frequency of a sampled sound Listing 22-15 Compressing audio data Listing 22-16 Playing an 'snd ' resource from disk Listing 22-17 Recording through the sound input dialog box Listing 22-18 Recording directly from a sound input device Listing 22-19 Determining the name of a sound input device Listing 22-20 Determining some sound input device settings Listing 22-21 Determining whether a sound channel is paused Listing 22-22 Determining the number of allocated sound channels Listing 22-23 Setting up double buffers Listing 22-24 Defining a doubleback procedure Listing 22-25 Issuing a callback command Listing 22-26 Defining a callback procedure æC line 11 of card 925 line 36 of card 925 line 70 of card 925 line 105 of card 925 line 127 of card 925 line 8 of card 926 line 4 of card 935 line 30 of card 935 line 10 of card 936 line 6 of card 939 line 23 of card 939 line 14 of card 940 line 334 of card 941 line 11 of card 943 line 12 of card 949 line 6 of card 951 line 4 of card 954 line 79 of card 955 line 36 of card 958 line 52 of card 958 line 60 of card 962 line 30 of card 963 line 4 of card 965 line 18 of card 966 line 11 of card 967 line 43 of card 967 æKY Time Manager.Sections æN About This Chapter About the Time Manager Time Manager Versions The Original Time Manager The Revised Time Manager The Extended Time Manager Other Time-Related Facilities The TickCount Function The Delay Function The Vertical Retrace Manager Using the Time Manager Installing and Activating Task Records Using Application Global Variables in Tasks Performing Periodic Tasks Computing Elapsed Time Time Manager Routines Summary of the Time Manager Data Types Routines Assembly-Language Information æC card 992 card 993 card 994 card 995 card 996 card 997 card 998 card 999 card 1000 card 1001 card 1002 card 1003 card 1004 card 1005 card 1006 card 1007 card 1008 card 1009 card 1010 card 1011 æKY Time Manager.Figures æN Figure 23-1 Drifting, unpredictable frequency. Figure 23-2 The extended Time Manager (drift-free, fixed frequency) æC line 5 of card 997 line 12 of card 997 æKY Time Manager.Listings æN Listing 23-1 Installing and activating a Time Manager task Listing 23-2 Passing the address of the application’s A5 world to a Listing 23-3 Defining a Time Manager task that can manipulate global variables Listing 23-4 Defining a periodic Time Manager task Listing 23-5 Computing elapsed time æC line 4 of card 1003 line 24 of card 1004 line 45 of card 1004 line 4 of card 1005 line 6 of card 1006 æKY Notification Manager.Sections æN About This Chapter About the Notification Manager Using the Notification Manager Creating a Notification Request Defining a Response Procedure Installing a Notification Request Removing a Notification Request Notification Manager Routines Summary of the Notification Manager Constant Data Types Routines Application-Defined Routines Result Codes æC card 1012 card 1013 card 1014 card 1015 card 1016 card 1017 card 1018 card 1019 card 1020 card 1021 card 1022 card 1023 card 1024 card 1025 æKY Notification Manager.Figures æN Figure 24-1 A notification in the Application menu Figure 24-2 A sample alert box æC line 43 of card 1013 line 75 of card 1013 æKY Notification Manager.Listings æN Listing 24-1 Setting up a notification record æC line 79 of card 1015 æKY File Manager.Sections æN About This Chapter About the File Manager Identifying Files, Directories, and Volumes File System Specifications The Evolution of File Specification Strategies Limitations on MFS Disks A Simpler Safe-Save Strategy New Special-Purpose Features A Quick, Thorough Catalog Search File IDs Shared Environments Remote Mounting Privilege Information in Foreign File Systems Using the File Manager Using FSSpec Records Updating Files Searching a Volume Tracking Files With File IDs Mounting Volumes Programmatically Handling Privilege Information in Foreign File Systems High-Level File Manager Routines Routines That Use FSSpec Records Making FSSpec Records Exchanging the Data in Two Files Functions Modified to Accept FSSpec Records Opening a Data Fork Managing HFS Functions New With HFS MFS Functions Modified to Accommodate Directory IDs Low-Level File Manager Routines Reading Volume Information Searching a Catalog Creating FSSpec Records Swapping Data Between Two Files Creating and Using File IDs Functions for Manipulating File IDs Functions Changed to Accommodate File IDs Mounting Volumes Accessing Privilege Information in Foreign File Systems Opening Data Forks Summary of the File Manager Constants Data Types Routines Result Codes Assembly-Language Information æC card 1026 card 1027 card 1028 card 1029 card 1030 card 1031 card 1032 card 1033 card 1034 card 1035 card 1036 card 1037 card 1038 card 1039 card 1040 card 1041 card 1042 card 1043 card 1044 card 1045 card 1046 card 1047 card 1048 card 1049 card 1050 card 1051 card 1052 card 1053 card 1054 card 1055 card 1056 card 1057 card 1058 card 1059 card 1060 card 1061 card 1062 card 1063 card 1064 card 1065 card 1066 card 1067 card 1068 card 1069 card 1070 card 1071 æKY File Manager.Figures æN Figure 25-1 Identifying a file in MFS Figure 25-2 Identifying a file in HFS Figure 25-3 The effect of ioSearchBits on ioSearchInfo1and ioSearchInfo2 æC line 14 of card 1030 line 64 of card 1030 line 151 of card 1042 æKY File Manager.Tables æN Table 25-1 How FSMakeFSSpec interprets file specifications Table 25-2 The effect of FSpExchangeFiles on a catalog entry Table 25-3 The effect of FSpExchangeFiles on a file control block Table 25-4 Fields in ioSearchInfo1 and ioSearchInfo2 used for a file Table 25-5 Fields in ioSearchInfo1 and ioSearchInfo2 used for a directory æC line 55 of card 1040 line 18 of card 1041 line 42 of card 1041 line 43 of card 1042 line 67 of card 1042 æKY File Manager.Listings æN Listing 25-1 Testing for PBCatSearch Listing 25-2 Opening a document using the FSSpec record Listing 25-3 Updating a file with FSpExchangeFiles Listing 25-4 Searching a volume with PBCatSearch æC line 105 of card 1039 line 26 of card 1040 line 63 of card 1041 line 172 of card 1042 æKY Standard File Package.Sections æN About This Chapter About the Standard File Package Using the Standard File Package Presenting the Default Interface Customizing Your Interface Customized Dialog Boxes Callback Routines Compatibility With Earlier Procedures Standard File Package Routines Saving Files Opening Files Summary of the Standard File Package Constants Data Types Routines Assembly-Language Information æC card 1072 card 1073 card 1074 card 1075 card 1076 card 1077 card 1078 card 1080 card 1081 card 1082 card 1083 card 1084 card 1085 card 1086 card 1087 card 1088 æKY Standard File Package.Figures æN Figure 26-1 The default Open dialog box Figure 26-2 The default Save dialog box Figure 26-3 The New Folder dialog box Figure 26-4 The name conflict dialog box æC line 7 of card 1075 line 18 of card 1075 line 23 of card 1075 line 28 of card 1075 æKY Standard File Package.Listings æN Listing 26-1 Opening a document Listing 26-2 The definition of the default Open dialog box Listing 26-3 The definition of the default Save dialog box Listing 26-4. The item list for the default Open dialog box Listing 26-5. The item list for the default Save dialog box æC line 40 of card 1075 line 6 of card 1077 line 18 of card 1077 line 36 of card 1077 line 52 of card 1077 æKY Alias Manager.Sections æN About This Chapter About the Alias Manager About Alias Records Search Strategies Fast Search Exhaustive Search Using the Alias Manager Creating Alias Records Resolving Alias Records ResolveAlias MatchAlias Maintaining Alias Records Getting Information About Alias Records Customizing Alias Records Alias Manager Routines Creating and Updating Alias Records Resolving and Reading Alias Records Filtering Possible Targets Summary of the Alias Manager Constants Data Types Routines Application-Defined Routine Result Codes Assembly-Language Information æC card 1089 card 1090 card 1091 card 1092 card 1093 card 1094 card 1095 card 1096 card 1097 card 1098 card 1099 card 1100 card 1101 card 1102 card 1103 card 1104 card 1105 card 1106 card 1107 card 1108 card 1109 card 1110 card 1111 card 1112 card 1113 æKY Alias Manager.Figures æN Figure 27-1 Resolving a relative path æC line 35 of card 1091 æKY Memory Management.Sections æN About This Chapter About Memory Management Dividing Memory Among Multiple Applications Extending an Application’s Available Memory Extending the Operating System’s Available Memory Controlling the System Memory Settings About the Memory Manager Using Master Pointers Using Window and Control Definition Functions Manipulating 24-Bit and 32-Bit Memory Addresses Using the Memory Manager Setting and Restoring the A5 Register Manipulating A5 Without MPW Memory Manager Routines Setting and Restoring the A5 World Manipulating Memory Addresses About Virtual Memory Using Virtual Memory Holding and Releasing Memory Locking and Unlocking Memory Obtaining Information About Virtual Memory Information About the System Memory Configuration Information About Page Mapping Deferring User Interrupt Handling Debugger Support Under Virtual Memory Bus Error Vectors Special Nonmaskable Interrupt Needs Supervisor Mode The Debugging State Keyboard Input Page States Virtual Memory Routines Holding and Releasing Pages Locking and Unlocking Pages Obtaining Page-Mapping Information Deferring User Interrupt Handling Determining Which Debugger Functions Are Present Determining Whether Paging Is Safe Locking and Unlocking Memory With Caching Enabled Entering and Exiting the Debugging State Obtaining Keyboard Input Determining Page State About Temporary Memory Using Temporary Memory Allocating Temporary Memory Locking Temporary Memory Unlocking Temporary Memory Releasing Temporary Memory Determining Features of Temporary Memory Temporary Memory Routines Requesting Temporary Memory Locking and Unlocking Temporary Memory Freeing Temporary Memory Summary of Memory Management Constants Data Types Memory Manager Routines Virtual Memory Routines Temporary Memory Routines Result Codes Assembly-Language Information æC card 1114 card 1115 card 1116 card 1117 card 1118 card 1119 card 1120 card 1121 card 1122 card 1123 card 1124 card 1125 card 1126 card 1127 card 1128 card 1129 card 1130 card 1131 card 1132 card 1133 card 1134 card 1135 card 1136 card 1137 card 1138 card 1139 card 1140 card 1141 card 1142 card 1143 card 1144 card 1145 card 1146 card 1147 card 1148 card 1149 card 1150 card 1151 card 1152 card 1153 card 1154 card 1155 card 1156 card 1157 card 1158 card 1159 card 1160 card 1161 card 1162 card 1163 card 1164 card 1165 card 1166 card 1167 card 1168 card 1169 card 1170 card 1171 card 1172 card 1173 card 1174 æKY Memory Management.Figures æN Figure 28-1 Memory organization in a single-application environment Figure 28-2 The organization of the application partition Figure 28-3 Memory organization in a multiple application environment Figure 28-4 Using temporary memory Figure 28-5 The Memory control panel Figure 28-6 A master pointer structure in the 24-bit Memory Manager æC line 3 of card 1115 line 10 of card 1115 line 9 of card 1116 line 7 of card 1117 line 3 of card 1119 line 3 of card 1121 æKY Memory Management.Listings æN Listing 28-1 Passing A5 to a notification response procedure Listing 28-2 Setting up and restoring A5 Listing 28-3 Translating logical to physical addresses Listing 28-4 Determining whether temporary memory routines are available æC line 6 of card 1125 line 31 of card 1125 line 32 of card 1136 line 6 of card 1162 æKY Process Management.Sections æN About This Chapter About Process Management How the Process Manager Creates Processes How the Process Manager Schedules Processes How Your Application Specifies Scheduling Options Using the Process Manager Opening or Printing Files Based on Finder Information Getting Information About Other Processes Launching Other Applications Specifying Launch Options Controlling Launched Applications Launching Desk Accessories Process Manager Routines Getting Process Information Launching Applications and Desk Accessories Summary of Process Manager Routines Constants Data Types Routines Result Codes Assembly-Language Information æC card 1175 card 1176 card 1177 card 1178 card 1179 card 1180 card 1181 card 1182 card 1183 card 1184 card 1185 card 1186 card 1187 card 1188 card 1189 card 1190 card 1191 card 1192 card 1193 card 1194 card 1195 æKY Process Management.Listings æN Listing 29-1 Searching for a specific process Listing 29-2 Launching an application æC line 86 of card 1182 line 80 of card 1183 æKY Slot Manager.Sections æN About This Chapter About the Slot Manager Card Initialization Using the Slot Manager Enabling and Disabling NuBus Cards Enabling and Disabling SResource Data Structures Searching for Disabled SResource Data Structures Restoring Deleted SResource Data Structures Slot Manager Routines The Slot Manager Parameter Block Determining the Version of the Slot Manager Getting Information About SResource Data Structures Enabling, Disabling, or Restoring SResources Summary of the Slot Manager Constants Data Types Routines Result Codes Assembly-Language Information æC card 1196 card 1197 card 1198 card 1199 card 1200 card 1201 card 1202 card 1203 card 1204 card 1205 card 1206 card 1207 card 1208 card 1209 card 1210 card 1211 card 1212 card 1213 card 1214 æKY Slot Manager.Tables æN Table 30-1 Slot Manager search routines Table 30-2 How the Slot Manager determines the base address used by æC line 6 of card 1202 line 55 of card 1208 æKY Slot Manager.Listings æN Listing 30-1 Disabling and enabling sResource data structures Listing 30-2 Searching for sResource data structures æC line 6 of card 1201 line 4 of card 1203 æKY Power Manager.Sections æN About This Chapter About the Power Manager The Idle State The Sleep State The Sleep Queue Sleep Requests Sleep Demands Wakeup Demands Sleep-Request Revocations Using the Power Manager Determining Whether the Power Manager Is Present Enabling or Disabling the Idle State Setting, Disabling, and Reading the Wakeup Timer Placing a Routine in the Sleep Queue Responding When the Sleep Queue Calls Your Routine Switching Serial Power On and Off Power Manager Routines Controlling the Idle State Controlling and Reading the Wakeup Timer Controlling the Sleep Queue Controlling Serial Power Reading the Status of the Internal Modem Reading the Status of the Battery & of the Battery Charger Summary of the Power Manager Constants Data Types Routines Result Codes æC card 1215 card 1216 card 1217 card 1218 card 1219 card 1220 card 1221 card 1222 card 1223 card 1224 card 1225 card 1226 card 1227 card 1228 card 1229 card 1230 card 1231 card 1232 card 1233 card 1234 card 1235 card 1236 card 1237 card 1238 card 1239 card 1240 card 1241 card 1242 æKY Power Manager.Figures æN Figure 31-1 Relationship of an application to the Power Manager Figure 31-2 How the sleep queue handles a sleep request Figure 31-3 How the sleep queue handles a sleep demand æC line 5 of card 1216 line 5 of card 1220 line 5 of card 1221 æKY Power Manager.Tables æN Table 31-1 Response of network services to sleep requests and demands æC line 12 of card 1220 æKY Power Manager.Listings æN Listing 31-1 Adding an entry to the sleep queue Listing 31-2 A sleep queue routine æC line 25 of card 1228 line 34 of card 1229 æKY AppleTalk Manager.Sections æN About This Chapter About the AppleTalk Manager Changes to the AppleTalk Manager AppleTalk Protocols Device Drivers, Connection Files, and the LAP Manager Using the AppleTalk Manager Determining Whether Phase 2 Drivers Are Present Deciding Which AppleTalk Protocol to Use The .MPP Driver Getting Information About the .MPP Driver A New NBP Wildcard Character The LAP Manager The AppleTalk Transition Queue Adding and Removing AppleTalk Transition Queue Entries Sending Messages to the AppleTalk Transition Queue How the AppleTalk Manager Calls Your Queue Entry Defining Your Own AppleTalk Transition The LAP Manager 802.2 Protocol Attaching and Detaching 802.2 Protocol Handlers The .ATP Driver Canceling All Calls to the ATPGetRequest Function Setting the Timeout Value for the ATP Release Timer The .XPP Driver Using the .XPP Driver to Obtain Information About Zones Obtaining Zone Information AppleTalk Data Stream Protocol (ADSP) Using ADSP The ADSP Connection Control Block The .DSP Parameter Block Opening and Maintaining an ADSP Connection Creating and Using a Connection Listener Writing a User Routine for Connection Events .DSP Driver Routines Establishing & Terminating an ADSP Connection Establishing & Terminating an ADSP Connection Listener Maintaining an ADSP Connection The .ENET Driver Providing Your Own Ethernet Driver Changing the Ethernet Hardware Address Opening the .ENET Driver Using a Write-Data Structure to Transmit Ethernet Data Using the Default Ethernet Protocol Handler to Read Data Using Your Own Ethernet Protocol Handler to Read Data How the .ENET Driver Calls Your Protocol Handler How Your Protocol Handler Calls the .ENET Driver .ENET Driver Routines Attaching and Detaching an Ethernet Protocol Handler Writing and Reading Ethernet Packets Adding and Removing Ethernet Multicast Addresses Summary of the AppleTalk Manager Constants Data Types Routines Global Variable Result Codes Assembly-Language Information æC card 1243 card 1244 card 1245 card 1246 card 1247 card 1248 card 1249 card 1250 card 1251 card 1252 card 1253 card 1254 card 1255 card 1256 card 1257 card 1258 card 1259 card 1260 card 1261 card 1262 card 1263 card 1264 card 1265 card 1266 card 1267 card 1268 card 1269 card 1270 card 1271 card 1272 card 1273 card 1274 card 1275 card 1276 card 1278 card 1279 card 1280 card 1281 card 1282 card 1283 card 1284 card 1285 card 1286 card 1287 card 1288 card 1289 card 1290 card 1291 card 1292 card 1293 card 1294 card 1295 card 1296 card 1297 card 1298 card 1299 æKY AppleTalk Manager.Figures æN Figure 32-1 AppleTalk protocols Figure 32-2 AppleTalk device drivers Figure 32-3 AppleTalk application interfaces Figure 32-4 AppleTalk Ethernet packet formats Figure 32-5 An Ethernet write-data structure æC line 47 of card 1246 line 18 of card 1247 line 23 of card 1247 line 13 of card 1260 line 3 of card 1284 æKY AppleTalk Manager.Listings æN Listing 32-1 Calling a LAP Manager L802.2 routine from assembly language Listing 32-2 Using the GetZoneList function Listing 32-3 Using the GetMyZone function Listing 32-4 Using ADSP to establish and use a connection Listing 32-5 Using ADSP to establish and use a connection listener Listing 32-6 An ADSP user routine Listing 32-7 Finding an EtherTalk card and opening the .ENET driver Listing 32-8 Sending a data packet over Ethernet Listing 32-9 Using the default Ethernet protocol handler to read data æC line 10 of card 1261 line 10 of card 1266 line 52 of card 1266 line 255 of card 1272 line 89 of card 1273 line 41 of card 1274 line 6 of card 1283 line 12 of card 1284 line 13 of card 1285 æKY Appendix A: Result Codes.Sections æN Appendix A: Result Codes æC card 1300 æKY Appendix A: Result Codes.Tables æN Table A-1 Result codes Table A-1 Result codes (Continued) æC line 8 of card 1300 line 1 of card 1300 æKY Appendix B: Routines and Their Memory Behavior.Sections æN Appendix B: Routines and Their Memory Behavior æC card 1302 æKY Appendix B: Routines and Their Memory Behavior.Tables æN Table B-1 Routines that may move or purge memory Table B-2 Routines that do not move or purge memory but may not be called Table B-3 Routines that may be called at interrupt time æC line 12 of card 1302 line 171 of card 1302 line 234 of card 1302 æKY Appendix C: System Traps.Sections æN Appendix C: System Traps æC card 1303 æKY Appendix C: System Traps.Tables æN Table C-1 System traps by trap name Table C-2 System traps by trap word Table C-3 System traps that take selectors Table C-4 Routines selected from system traps æC line 12 of card 1303 line 75 of card 1303 line 1 of card 1303 line 1 of card 1303 æKY Appendix D: Global Variables.Sections æN Appendix D: Global Variables æC card 1306 æKY Appendix D: Global Variables.Tables æN Table D-1 Global variables æC line 4 of card 1306 æKY Appendix E: The Standard Roman Character Set.Sections æN Appendix E: The Standard Roman Character Set æC card 1307 æKY Appendix E: The Standard Roman Character Set.Tables æN Table E-1 The standard Roman character set Table E-2 Unencoded PostScript characters æC line 7 of card 1307 line 115 of card 1307 æKY Glossary.Sections æN Glossary æC card 1309